home *** CD-ROM | disk | FTP | other *** search
/ Amiga CD-Sensation: Golden Games / Amiga CD-Sensation - Ausgabe 2 - Golden Games (1996)(GTI - Schatztruhe)(DE)[!].iso / Brain Activity / JMines / JMines.doc < prev    next >
Text File  |  1993-06-20  |  9KB  |  238 lines
  1. ***********************************************************
  2. *                                                         *
  3. *                   JMines Version 1.0                    *
  4. *                                                         *
  5. *                  (c) 1993 James Blake                   *
  6. *                                                         *
  7. ***********************************************************
  8.  
  9.  
  10. SHORT DESCRIPTION
  11. -----------------
  12.  
  13. JMines is yet another version of the game Minesweeper (or X-Mines).  There
  14. are three levels of difficulty and a high-score list for each level of
  15. difficulty.  It requires Workbench 2.0 and runs on the default public
  16. screen.  The object of the game is to find all of the mines hidden in a
  17. field.  Written entirely in Amiga E.
  18.  
  19.  
  20. DISTRIBUTION
  21. ------------
  22.  
  23. JMines is shareware.  I request that if you keep this game on your hard-
  24. drive for more than 2 weeks, or if you play it frequently please register
  25. by sending $5 (Canadian or American) to me (Address located further in this
  26. document).
  27.  
  28. For more complete distribution information see the file JMines.README.
  29.  
  30.  
  31. BACKGROUND
  32. ----------
  33.  
  34. JMines is a version of the often copied game that I first saw on Windows.
  35. At the time there were no versions for the Amiga so I decided I'd write one.
  36.  
  37. Initially I tried to write a version in C, but I didn't get very far before
  38. I became fed up.  Not having any good books on programming the Amiga.  I
  39. then came across Amiga E and decided I liked the language very much, and
  40. wanted something to try and program.  I figured that I should try and do a
  41. version of Mines to test the Language and to get used to programming the
  42. Amiga.  It took about 6 hours to get a version of mines that I could play.
  43. It then took me about two months of intermittent work to add the features
  44. that I wanted, and figure out how to deal with gadgets, loading fonts, etc...
  45.  
  46. Meanwhile a few different versions of Mines have shown up on the Amiga.
  47. None though had everything I wanted.  What I wanted was one that:
  48.  
  49. 1.  Used the Workbench screen.
  50. 2.  Had different levels of difficulty.
  51. 3.  Had good hi-score lists.
  52. 4.  Was stable on my machine.
  53. 5.  Wouldn't permit cheating.
  54.  
  55. My programming accomplished all of these except #5.
  56.  
  57.  
  58. HARDWARE/SOFTWARE REQUIREMENTS
  59. ------------------------------
  60.  
  61. This program requires an Amiga with WB2.04 or above. (If there is a demand I
  62. can release a WB1.3 version -- It has been written, I just have to switch
  63. the colours and add some error checking and stuff.)
  64.  
  65. Although not strictly a requirement JMines works best on an interlace
  66. screen.  If you are using a non-interlace screen it must be at least 212
  67. pixels high, otherwise there is not enough room and program will quit and
  68. give you an error message.  On a non-interlace screen you will only be able
  69. to play the tough level (not the tougher or toughest levels).
  70.  
  71.  
  72. INSTALLATION
  73. ------------
  74.  
  75. This game requires the font tyrvas/8 (included with this distribution.)
  76. It can be either copied to the fonts: directory or, by using the CLI command
  77. below you can test it without further cluttering up your fonts directory.
  78.  
  79. ASSIGN FONTS: jmines/fonts ADD
  80.               ^^^^^^^^^^^^
  81.               Replace this with the location of tyrvas.font.
  82.  
  83. (The included script use font does this for you.
  84.  
  85. There was no documentation with the copy of the tyrvas font that I got.
  86. I assume that it is in the public domain (Or at least freely distributable)
  87. It is a very useful font.  I use it for my default system font.
  88.  
  89. You should also note that this program creates a file in the S: directory
  90. called 'jmines.hiscore.'
  91.  
  92.  
  93. GETTING STARTED
  94. ---------------
  95.  
  96. JMines may be started by using either the workbench or CLI.  Simply double
  97. click on the JMines Icon.  It will automatically start on the default
  98. public screen.
  99.  
  100. Initially the panel screen appears.  Different levels may be selected using
  101. the radio buttons.  The gadgets should be self explanatory, the 'Continue
  102. gadget is only enabled if you stop in the middle of a game by selecting the
  103. close window gadget.
  104.  
  105.  
  106. HOW TO PLAY JMINES
  107. ------------------
  108.  
  109. Mines is a very simple game.  Upon selecting new game a field will be drawn.
  110. The size of the field, as well as the number of mines depends upon the level
  111. selected.  One plays by clicking with the Left Mouse Button (Select button)
  112. on a cell within the field.  If that cell is a mine, well --BOOOOM!!!-- game
  113. over.  If not though, it will tell you how many mines there are surrounding
  114. that cell (this includes the cells touching  on the corners).  If there
  115. are no mines around that cell, it will automatically select all of the
  116. surrounding cells.  Cells can be flagged as containing a mine by clicking
  117. the Right Mouse Button (Menu button -- RMB).  This is more for your
  118. convenience in marking the minefield than anything else.  If you change your
  119. mind and decide that the cell does not contain a mine, another click with
  120. the RMB will change it back to a blank cell.  You win when all of the cells
  121. not containing mines have been selected.  The object is to do this as quick
  122. as possible.
  123.  
  124.  
  125. STRATEGY
  126. --------
  127.  
  128. Initially you will spend most of your time counting unselected cells
  129. surrounding a cell with a known number of mines surrounding it.  As you
  130. become more proficient you will be able to do this quicker.
  131.  
  132. Some specific strategy points.
  133.  
  134.  - Corners are good initial guesses as they have the least number of
  135.    squares surrounding them (and therefore most likely to have 0 mines.)
  136.  
  137.  - If you cannot find any place that is definitely not a mine.  Try using
  138.    logic like "If this one is not a mine, then neither of these two can be
  139.    a mine, but one of these two must be a mine, therefore ..."  This is most
  140.    effective near the edges.
  141.  
  142.  - Watch for recurring patters that logic can be applied to.  You will then
  143.    be able to know which ones are mines without having go through the
  144.    trouble of applying the logic.  One example is:
  145.  
  146.    X - Unselected  number - number of mines (N is any number)
  147.  
  148.                      0NX
  149.                      01X   <-  Is a mines.
  150.                      02X   <-  Is not a mine.
  151.                      01X   <-  Is a mine.
  152.                      0NX
  153.  
  154. HIGH-SCORES
  155. -----------
  156.  
  157. The hiscore list is set-up so that even I can get the number one position.
  158. Johanna, my official playtester, has the following high-scores
  159. (Without cheating):
  160.  
  161.    Tough:      0:18
  162.    Tougher:    0:45
  163.    Toughest:   2:48
  164.  
  165.  
  166. KNOWN BUGS
  167. ----------
  168.  
  169. 1.  Intermittent bug:  Occasionally when window size is changed, the mine
  170.     field is not completely drawn.  This does not interfere with play.  If
  171.     you start a new game the minefield will be drawn correctly.
  172.  
  173. 2.  More serious, but much more rare:  On occasion when I have gotten the
  174.     number one position on the toughest level I have caused a software
  175.     failure.  I have been unable to duplicate this.  (This bug seems to
  176.     have been fixed, but I'm not quite sure what fixed it.)
  177.  
  178. 3.  Theoretical bug:  The uncovering of cells with zero sourrounding cells
  179.     is done with recursion.  It is theoretically possible to overflow the
  180.     stack if there is a _very_ large open space.  This has only happened to
  181.     me when I was bug squashing and had only 5 mines at the toughest level.
  182.  
  183.  
  184. FUTURE PLANS
  185. ------------
  186.  
  187. Some features that may be added to future versions of JMines.
  188.  
  189.   - Sound for explosion, and winning.
  190.   - Ability to specify public screen with PUBSCREEN=<>
  191.   - Ability to set JMines's window position. (Possibly have it open at the
  192.     pointer position.)
  193.   - Blank mine field window when not active.
  194.   - Automatically clean or mark neighbours of a square.
  195.  
  196.  
  197. ACKNOWLEDGMENTS
  198. ---------------
  199.  
  200. Wouter van Oortmerssen: for creating the best programming language ever, and
  201.         for putting up with my dumb questions.
  202.  
  203. Johanna: for playtesting JMines extensively (and for being so cute).
  204.  
  205. whoever created the font tyrvas.
  206.  
  207.  
  208. REGISTRATION, BUG REPORTS, INCOMPATABILITY REPORTS, AND COMMENTS
  209. ----------------------------------------------------------------
  210.  
  211. If you have any problems with JMines on your set-up please e-mail (or paper
  212. mail if you must) me with the following information:
  213.   - what machine are you using,
  214.   - what public screen it was running on,
  215.   - What version of JMines you have,
  216.   - what version of Kickstart & WB you are using, and
  217.   - anything else that seems relevant.
  218.  
  219. I may be reached at:
  220.  
  221. ua581@freenet.victoria.bc.ca
  222.  
  223. (If this bounces try jblake@sirius.uvic.ca  --before August 1993
  224.            James c/o jmantsin@sirius.uvic.ca  --after September 1993)
  225.  
  226. For registratrion and those who do not have access to e-mail my address is
  227.  
  228.        James Blake
  229.        1718 Midgard Avenue
  230.        Victoria, B.C
  231.        V8P 2Y5
  232.  
  233.  
  234. Please send $5 (American or Canadian) Either cheque, money-order or cash.
  235. If you are outside of North America send me the lowest paper denomination,
  236. or some other token.
  237.  
  238.                -June 1993-